HEX
Server: Apache/2.4.58 (Ubuntu)
System: Linux ip-172-26-0-120 6.17.0-1009-aws #9~24.04.2-Ubuntu SMP Fri Mar 6 23:50:29 UTC 2026 x86_64
User: ubuntu (1000)
PHP: 8.3.6
Disabled: NONE
Upload Files
File: /var/www/html/dashboard.orbiwheels.com/vendor/cuyz/valinor/src/Utility/TypeHelper.php
<?php

declare(strict_types=1);

namespace CuyZ\Valinor\Utility;

use CuyZ\Valinor\Type\BooleanType;
use CuyZ\Valinor\Type\CompositeTraversableType;
use CuyZ\Valinor\Type\CompositeType;
use CuyZ\Valinor\Type\FloatType;
use CuyZ\Valinor\Type\IntegerType;
use CuyZ\Valinor\Type\ObjectType;
use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
use CuyZ\Valinor\Type\ScalarType;
use CuyZ\Valinor\Type\StringType;
use CuyZ\Valinor\Type\Type;
use CuyZ\Valinor\Type\Types\NullType;
use CuyZ\Valinor\Type\Types\UnresolvableType;
use CuyZ\Valinor\Type\VacantType;

/** @internal */
final class TypeHelper
{
    /**
     * Sorting the types by priority: objects, arrays, scalars/null, everything else.
     */
    public static function typePriority(Type $type): int
    {
        return match (true) {
            $type instanceof ObjectType => 3,
            $type instanceof CompositeTraversableType => 2,
            $type instanceof ScalarType,
            $type instanceof NullType => 1,
            default => 0,
        };
    }

    /**
     * Sorting the scalar types by priority: int, float, string, bool.
     */
    public static function scalarTypePriority(ScalarType $type): int
    {
        return match (true) {
            $type instanceof IntegerType => 4,
            $type instanceof FloatType => 3,
            $type instanceof StringType => 2,
            $type instanceof BooleanType => 1,
            default => 0,
        };
    }

    /**
     * @return list<Type>
     */
    public static function traverseRecursively(Type $type): array
    {
        $types = [];

        if ($type instanceof CompositeType) {
            foreach ($type->traverse() as $subType) {
                $types = [...$types, $subType, ...self::traverseRecursively($subType)];
            }
        }

        return $types;
    }

    /**
     * @param non-empty-array<non-empty-string, Type> $vacantTypes
     */
    public static function assignVacantTypes(Type $type, array $vacantTypes): Type
    {
        try {
            return self::doAssignVacantTypes($type, $vacantTypes);
        } catch (InvalidType $exception) {
            return new UnresolvableType($type->toString(), $exception->getMessage());
        }
    }

    /**
     * @param non-empty-array<non-empty-string, Type> $vacantTypes
     */
    private static function doAssignVacantTypes(Type $type, array $vacantTypes): Type
    {
        if ($type instanceof VacantType && isset($vacantTypes[$type->symbol()])) {
            return $vacantTypes[$type->symbol()];
        }

        if ($type instanceof CompositeType) {
            return $type->replace(
                static fn (Type $subType) => self::doAssignVacantTypes($subType, $vacantTypes),
            );
        }

        return $type;
    }
}